home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Tools / Docs / DMS < prev    next >
Text File  |  1994-06-07  |  15KB  |  460 lines
  1. FILE: DMS.doc - AmigaDOS version 1.11 documentation  - 7/1/91
  2.  
  3. *****************************************************************************
  4.  
  5.                           The DISK-Masher
  6.                    Copyright (c) 1989-1991 SDS Software
  7.  
  8.  
  9. *****************************************************************************
  10.  
  11.  
  12. What is it?
  13.  
  14.     The DISK-Masher (DMS) is a utility that allows users to compress and
  15. archive floppy disks.  Version 1.11 requires at least 512k of memory, and
  16. AmigaDOS version 1.2 or later.
  17.  
  18. Why a disk archiver?
  19.  
  20.     Many programs are available for archiving individual files and do a
  21. relatively good job.  However DMS was created for the purpose of archiving
  22. whole disks.  It is useful for archiving non-filing system disks which cannot
  23. be done with standard file archivers, sending distribution disks, archiving
  24. library collections, and many other uses.  DMS takes much less time to
  25. put a disk back together than with a file archiver and is less wear and
  26. tear on your disk drives.
  27.  
  28. Why not use other disk archivers?
  29.  
  30.     DMS has been tested against every other similar type programs and will
  31. provide faster execution, greater compression, more support features, and
  32. continuing user support.  Once you try DMS you won't be satisfied with
  33. anything else.  Among other things DMS provides:
  34.  
  35.     - Highly optimized compression routines offerring the utmost
  36.       in speed and compression.  4 different routines to choose from
  37.       to satisfy your needs.
  38.  
  39.     - The ability to read and write to or from any AmigaDOS device conforming
  40.       to the standard 80 tracks , 512 bytes per block , 11 blocks per track,
  41.       2 sides, Ex: DF0:, DF1:, RAD:, etc.
  42.  
  43.     - Extended Virus checking of the boot blocks.  Other disk archivers
  44.       just show the boot block and do not check for viruses, this is
  45.       extremely stupid, most viruses do not come out and say "Look here,
  46.       I'm a virus!".  Without actually checking the boot block you're
  47.       opening up a can of worms.  Therefore DMS currently checks for over
  48.       60 different viruses and custom boot blocks and can automatically
  49.       install the disk.  It is still Important that users monitor their
  50.       system periodically with a virus checker as there are many types
  51.       of viruses. 
  52.  
  53.     - Data Security.  DMS has the option to encrypt archives with a user
  54.       selected password for security.
  55.  
  56.  
  57. *****************************************************************************
  58.  
  59.                     Command Line Options and Usage
  60.  
  61.   The general format for a DMS command is:
  62.  
  63.   DMS command file[.DMS] [OPTIONS ...]
  64.  
  65.   Everything in braces [] is optional. Everything else is required.
  66.  
  67.   file[.DMS] is a user specified filename.  The .DMS ending will
  68.   automatically be appended to the filename if you do not include it.
  69.   This is done to avoid confusion with other archiver formats.
  70.  
  71.  
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73.  
  74. 1.) READ
  75.  
  76.   This command will read and compress a disk.  The basic usage for this
  77.   command is:
  78.  
  79.   DMS Read file[.DMS] [FROM Dev:] [TEXT filetext] [CMODE mode] [LOW lowtrack]
  80.                       [HIGH hightrack] [NOVAL] [NOZERO] [ENCRYPT password]
  81.  
  82.   file[.DMS]
  83.  
  84.   - the output file which will contain the archived disk.
  85.  
  86. OPTIONS:
  87.  
  88.   FROM Dev:
  89.  
  90.   - Will read the disk from a different device.  The default device is DF0:
  91.     (internal drive).  You may choose any device as long as it has 80 tracks,
  92.     2 sides, 11 sectors/track, and 512 bytes per sector.
  93.     Examples: DF0:, DF1:, DF2:, DF3:, RAD:, FM0:, FF0:, etc.
  94.  
  95.   TEXT filetext
  96.  
  97.   - Causes DMS to read in the file 'filetext' and add it to the archive.
  98.     When the archive is extracted the text will be displayed before writing
  99.     the disk.  This is useful for identifying disks or giving other
  100.     information about the archive.  
  101.  
  102.   CMODE mode
  103.  
  104.   - Chooses the compression mode used.  Mode is either NONE, HEAVY1, HEAVY2,
  105.     or BEST
  106.  
  107.     The default mode is BEST
  108.  
  109.     Available modes are:
  110.  
  111.       NONE   - No Compression is performed (Straight Read).
  112.       HEAVY1 - Heavy compression, good speed/compression ratio.
  113.       HEAVY2 - Best available compression.  Only available with >1meg ram.
  114.       BEST   - Chooses Best compression method for available memory.
  115.  
  116.   LOW lowtrack
  117.  
  118.   - Specifies the starting track to read from.  The default is track 0.
  119.     Lowtrack must be a value from 0 to 79.
  120.  
  121.   HIGH hightrack
  122.  
  123.   - Specifies the ending track to stop at.  The default is track 79.
  124.     Hightrack must be a value from 0 to 79.
  125.  
  126.   NOVAL
  127.  
  128.   - Stops DMS from inhibiting the disk validator when reading the disk.
  129.  
  130.   NOZERO
  131.  
  132.   - Normally DMS will read the AmigaDOS bitmap from the disk and archive
  133.     only sectors which are being used.  If the disk is a non-filing system
  134.     disk or has a bad bitmap, DMS will automatically archive the whole disk.
  135.     In EXTREME cases DMS will make a wrong assumption about the type of
  136.     disk it is archiving. NOZERO will cause DMS to archive the whole disk
  137.     totally ignoring the disk bitmap.  Generally you will rarely if ever
  138.     have to use this option.
  139.  
  140.   ENCRPYT password
  141.  
  142.   - Causes DMS to encrypt the input from the disk using the password
  143.     supplied. 'password' is any alphanumeric word you desire.
  144.     Examples: Joe, Fred, ABC1234, ONLY-FOR-ME, etc.
  145.  
  146. EXAMPLES:
  147.  
  148.   DMS read disk1
  149.  
  150.   - Will compress a disk from drive DF0: using the default compression mode
  151.     and store the results in the file 'disk1.DMS'
  152.  
  153.   DMS read stuff.DMS lowtrack 20
  154.  
  155.   - Will compress only tracks 20 to 79 into file 'stuff.DMS'
  156.  
  157.   DMS read stuff lowtrack 40 hightrack 40
  158.  
  159.   - Will compress only track 40 into file 'stuff.DMS'
  160.  
  161.   DMS read stuff from df1: cmode heavy1 noval nozero text RAM:intro
  162.  
  163.   - Will compress a disk from drive DF1: using compression mode HEAVY1, not
  164.     inhibiting the disk validator, not using the disk bitmap and adding
  165.     the text from file 'RAM:intro' to the file 'stuff.DMS'
  166.  
  167.   DMS read stuff.DMS from RAD: encrypt JOESTUFF1
  168.  
  169.   - Will compress a disk from ram drive RAD: and encrypting the output
  170.     with the password 'JOESTUFF1' to file 'stuff.DMS'
  171.  
  172.   DMS read stuff.DMS text CON:0/0/640/200/window
  173.  
  174.   - Will compress a disk and allow you to quickly add text to the archive.
  175.     A console window will open up and you can then type any text you
  176.     want.  To finish type CTRL \ to close the window and continue.
  177.  
  178.  
  179. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  180.  
  181. 2.) WRITE
  182.  
  183.   This command will uncompress and write a disk.  The basic usage for this
  184.   command is:
  185.  
  186.   DMS Write file[.DMS],,, [TO Dev:] [LOW lowtrack] [HIGH hightrack]
  187.                           [NOVAL] [NOTEXT] [NOPAUSE] [DECRYPT password]
  188.  
  189.   file[.DMS],,,
  190.  
  191.   - One or more input files to be extracted.  Standard AmigaDOS wildcards
  192.     are supported.
  193.  
  194. OPTIONS:
  195.  
  196.   TO Dev:
  197.  
  198.   - Will write the output to device Dev: (the default is drive DF0:)
  199.     The device must follows the same rules as in the READ command.
  200.  
  201.   LOW lowtrack
  202.  
  203.   - Specifies the starting track to write from.  Tracks before lowtrack
  204.     will be ignored.  Default is track 0
  205.  
  206.   HIGH hightrack
  207.  
  208.   - Specifies the ending track to write from.  Tracks after hightrack
  209.     will be ignored.  Default is track 79
  210.  
  211.   NOVAL
  212.  
  213.   - Stops DMS from inhibiting the disk validator when writing a disk.
  214.  
  215.   NOTEXT
  216.  
  217.   - Causes DMS to ignore any text to be displayed from the archive.
  218.  
  219.   NOPAUSE
  220.  
  221.   - Stops DMS from pausing after displaying any text from the archive.
  222.  
  223.   DECRPYT password
  224.  
  225.   - Causes DMS to decrypt the archive with the password 'password'.
  226.     This is only used if the archive was previously encrypted.  'password'
  227.     must be the EXACT same one used when encrypting the file otherwise
  228.     the archive will not be processed correctly.
  229.  
  230. EXAMPLES:
  231.  
  232.   DMS write stuff
  233.  
  234.   - Will extract the archive stuff.DMS to drive DF0:
  235.  
  236.   DMS write part1 part2.dms TO DF2: NOTEXT
  237.  
  238.   - Will extract the archives part1.DMS and part2.DMS to drive DF2: ,
  239.     ignoring any banner text in the archives
  240.  
  241.  
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  243.  
  244. 3.) REPACK
  245.  
  246.   This command allows you to recompress an older DMS archive.  It can also
  247.   be used as a simple split utility.  The basic usage for this
  248.   command is:
  249.  
  250.   DMS Repack file[.DMS] [TO file2[.DMS]] [LOW lowtrack] [HIGH hightrack]
  251.                         [CMODE mode]
  252.  
  253.   file[.DMS]
  254.  
  255.   - The input file to be recompressed.
  256.  
  257. OPTIONS:
  258.  
  259.   TO file2[.DMS]
  260.  
  261.   - Causes DMS to store the results in file2.DMS , otherwise the results
  262.     are automatically stored in a file TEMP.DMS
  263.  
  264.   LOW lowtrack
  265.  
  266.   - Specifies lowtrack to start recompression.  Tracks before lowtrack
  267.     will be ignored.  Default is track 0.
  268.  
  269.   HIGH hightrack
  270.  
  271.   - Specifies hightrack to end recompression.  Tracks after hightrack
  272.     will be ignored.  Default is track 79.
  273.  
  274.   CMODE mode
  275.  
  276.   - Chooses the compression mode to use.  Same as in the READ command.
  277.  
  278. EXAMPLES:
  279.  
  280.   DMS repack stuff low 20 high 40 cmode NONE
  281.  
  282.   - Will extract tracks 20 through 40 from the archive stuff.DMS ,
  283.     recompress them using no compression and store the  results
  284.     in the file TEMP.DMS .
  285.  
  286.   DMS repack old.dms TO new.dms
  287.  
  288.   - Will recompress the archive old.DMS using the default compression mode
  289.     and store the results in the file new.DMS
  290.  
  291.  
  292. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  293.  
  294. 4.) VIEW
  295.  
  296.   This command will view information about a DMS archive.  The basic usage
  297.   for this command is:
  298.  
  299.   DMS View file[.DMS],,, [FULL]
  300.  
  301.   file[.DMS],,,
  302.  
  303.   - One or more input files to be viewed.  Standard AmigaDOS wildcards
  304.     are supported.
  305.  
  306. OPTIONS:
  307.  
  308.   FULL
  309.  
  310.   - Causes DMS to display information about every track in the archive.
  311.     Otherwise only the information header will be displayed.
  312.  
  313. EXAMPLES:
  314.  
  315.   DMS view file1 part#? full
  316.  
  317.   - Will display full information about the archives file1.DMS and
  318.     the files part#?.DMS
  319.  
  320.  
  321. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  322.  
  323. 5.) TEST
  324.  
  325.   This command will test the integrity of a DMS archive.  The basic usage
  326.   for this command is:
  327.  
  328.   DMS Test file[.DMS],,,
  329.  
  330.   file[.DMS],,,
  331.  
  332.   - One or more input files to be tested.  Standard AmigaDOS wildcards
  333.     are supported.
  334.  
  335. EXAMPLES:
  336.  
  337.   DMS test file1 part#?
  338.  
  339.   - Will test the archives file1.DMS and the files part#?.DMS
  340.  
  341.  
  342. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  343.  
  344. 6.) TEXT
  345.  
  346.   This command will display any banner text in a DMS archive.  This is
  347.   used to quickly find out information about an archive without having
  348.   to extract it.  The basic usage for this command is:
  349.  
  350.   DMS Text file[.DMS],,,
  351.  
  352.   file[.DMS],,,
  353.  
  354.   - One or more input files to display text.  Standard AmigaDOS wildcards
  355.     are supported.
  356.  
  357. EXAMPLES:
  358.  
  359.   DMS text file1 part#?
  360.  
  361.   - Will display any banner text from the archives file1.DMS and the files
  362.     part#?.DMS
  363.  
  364. *****************************************************************************
  365.  
  366.                        General Information
  367.  
  368.     DMS has been over a year in the making,  the compression routines
  369. are proprietary and we have taken great care to make sure they are the
  370. very best. There is no other program even close to DMS as far as versatility,
  371. performance, and ease of use.  We urge users to register with us so that we
  372. continue to provide the best and continuing support of the product.
  373.  
  374.     This program is NOT Shareware or Public Domain, it is Copyright 1989-91
  375. by SDS Software.  We have taken a different approach in distributing this
  376. program than most people.  There will always be a version of DMS available
  377. to the general public free of charge.  However, we are offerring as an
  378. incentive to register, many other programs that will not be available to
  379. the general public.  We feel that you should get what you pay for and pay
  380. for what you use.  Therefore if you seldom use DMS then the public version
  381. is fine for you and we thank you for using it.  If you use DMS on a regular
  382. basis you are asked to register with SDS Software.  Registering will enable
  383. you to receive future updates and other programs not available to the
  384. general public.  Updates will be provided to users on a first-come,
  385. first-serve basis before public releases.  Please make sure that this program
  386. remains the very best by registering with us.
  387.  
  388.     There are 2 levels of registration to choose from:
  389.  
  390.     Regular:
  391.     -------
  392.  
  393.         For $30 you will be mailed the latest versions of DMS on disk,
  394.         and will also receive:
  395.  
  396.         DMSWin - an Intuition version of DMS with full windowing, gadgets
  397.                  and graphical display.
  398.  
  399.         and other Public Domain SDS Software programs.
  400.  
  401.     Professional:
  402.     ------------
  403.  
  404.         For $50 you will receive the same privileges as above but will also
  405.         receive:
  406.  
  407.         Convert - a Warp-to-DMS converter to convert old .WRP files to the
  408.                   new .DMS format.
  409.  
  410.         ViewDMS - a small utility to view the contents of a DMS archive.
  411.  
  412.         TestDMS - a small utility to test the contents of a DMS archive.
  413.  
  414.         Convert.EXE - MS-DOS versions of the above programs. for people
  415.         ViewDMS.EXE   storing files on MS-DOS machines.
  416.         TestDMS.EXE
  417.  
  418.         You will also receive free updates for a year, and any other DMS
  419.         related programs that are developed or received by SDS Software.
  420.  
  421.     Send a Check or Money Order for the amount of registration you choose, 
  422. along with your full name, address, phone number, and computer configuration
  423. to:
  424.  
  425.     SDS Software
  426.     Suite 126
  427.     4885-A Mcknight Rd.
  428.     Pittsburgh, PA  15237
  429.  
  430.     It is our sincere hope that we can continue to service the Amiga
  431. community with new and innovative programs.  Please allow us to do so by
  432. supporting our products which you use.  Thank you.
  433.  
  434.     If you have any suggestions, complaints, questions, or bug reports,
  435. please write to the above address and be sure to include your full name,
  436. address, phone number, and computer configuration.  For any correspondance
  437. requiring a reply, please included a SASE.
  438.  
  439.     The DISK-Masher (DMS) is Copyright (c) 1989-1991 by SDS Software.
  440. It is NOT Public Domain.  The CLI/Shell GENERIC version is freely
  441. distributable provided the following rules:
  442.  
  443.     1.  No charge excepting reasonable media costs may be charged.
  444.  
  445.     2.  The program and documentation may not be modified in any way.
  446.  
  447.     3.  Only the self-extracting archive DMSxxx.EXE may be distributed
  448.  
  449.     SDS Software will be in no way liable for damages, incidental, or
  450. consequential, arising from the use or misuse of The DISK-Masher or for
  451. any other claim by any other party.  Use this program at your own risk.
  452. No warranty is given, either expressed or implied.  Terms of registration
  453. are subject to change without notice.
  454.  
  455. *****************************************************************************
  456.  
  457.     Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  458.     MS-DOS is a trademark of Microsoft.
  459.  
  460.